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1 . TURTLE OVERVIEW 


The turtle package provides the user with the ability to generate 
screen graphics using a few simple keyboard commands. The drawing 
element is called a turtle, which may move around the screen leaving 
"tracks" (or not, at the user's discretion). His motion and direction 
are controlled with five commands, each of which is a single keystroke: 

V 

H - Place turtle on home position (center of screen). 

N - Point turtle north (up). 

R - Rotate turtle 45° clockwise. 

L - Rotate turtle 45° counterclockwise. 

F - Move turtle forward one unit. 

These commands are sufficient to draw pictures of any degree of com- 
plexity, when coupled with other commands and capabilities. Beyond 
the command set provided by the turtle package, the user may define 
additional commands which are conglomerations of other system or user 
commands. Nested and/or recursive command structures may be defined 
which behave very much like programs in more procedure-oriented lang- 
uages. 

1#1 TURTLE'S DOMAIN 

The turtle's domain consists of two regions: (1) the visible region and 
(2) the invisible region. The domain is fixed in size as a 65536 by 
65536 "sphere" with the visible region being variable in size, depending 
on the current display mode and resolution. The turtle may be confined 
to the visible region or not, at the user's discretion. 
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TURTLE'S DOMAIN 
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Note that the domain is "spherical" in that the East & West 
edges are joined as are the North & South edges . 
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The turtle is always defined by his position and orientation. From 
his position, he may move to any of 8 adjacent "cells" based upon his 
orientation, as shown below. 
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In addition to moving to an adjacent cell, the turtle may also "sense" 
whether a cell is in the visible region or not, and detect the presence 
of a "track" in an adjacent cell. 

1.2 DRAWING 

The turtle draws by leaving "tracks" with a magic marker which is con- 
trolled with three commands. 

U--which stands for pen ujj; this allows the turtle to move without 
leaving tracks. 

P--is the £§n select command; this selects one of three colors for 
the pen, or erase (which removes tracks that the turtle crosses). 

D--which stands for pen down ; this causes the turtle to leave 
tracks of the current pen color. 
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The turtle can also detect tracks that are already in his region with the 
"S" (sense) command. 

1.3 CONTROL OF THE TURTLE 

The turtle is controlled by keyboard commands, which are executed as 
they are entered. Command execution may be deferred, however, by using 
the nesting capability provided by the () and C J matched sets. Thus, if 
(CHNR999F) is entered, none of the commands within the parens will be exe- 
cuted until the matching right paren is entered--at which time the string 
of commands will be executed at full speed. The command string above does 
the following: 

C - Clear the screen 
H - Home the turtle 
N - Face him North 

R - Rotate him to the right (now facing NE) 

999F - Move forward 999 times (each time leaving a track, if 
the pen is down). 

This example illustrates another feature, that of repetition (or iteration); 
a number preceding a command indicates that the command is to be executed 
as many times as indicated by the number. This feature also applies to the 
nesting brackets; thus, the example below includes nested iterations: 

4(2R 4 (10F2R) ) 

Draws a square 


Draws 4 squares with a common corner: 
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1.4 KEYBOARD CONTROL 

The keyboard is monitored at all times, even while a command is being exe- 
cuted; if a key is pressed, the current command is temporarily suspended, 
the newly entered command is executed, and then the prior command is re- 
sumed. This command interruption may actually be accomplished to any num- 
ber of levels (commands interrupting commands interrupting commands, etc.). 

The BREAK key will stop all command activity and put the turtle into an 
idle state. 

1.5 USER DEFINED COMMANDS 

The user may define unused keys to be "macro" commands--conglomerates of 
intrinsic and/or user defined commands. These commands may recurse, if 
desired, and may also, in turn, define other commands or redefine themselves 
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2. COMMAND FORMS 

Turtle commands fall into one of six forms, as will be described in 
the paragraphs that follow. 

< 

2.1 SINGLE LETTER 

<command> ;: = <name> 

Many commands are of this form, where a single key stroke 

(the name ) is the command. Examples are: H (Home), C (Clear), 
F (Forward). 

2.2 TESTING COMMANDS 

<command> ::= <name> <then> <else> 

There are four commands of this form, where a test is made and 
either the <then> clause or the <else> clause is executed, (but 
not both). Examples are: T (Test Acc.), E (Edge test) and ? (Ran- 
dom test) . 

2.3 ITERATION 

<command^ ::= <^value]> <^clause)> 

There are three commands of this form, where a numeric value is 
used to iterate a following clause. Examples are: A (Iterate by 
ACC), #v (Iterate by variable), and n (Iterate by number). 
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NESTING 



There are two nesting bracket sets: (...) and 





2.5 COMMAND/ VALUE 


^commanc^ ^name^ ^value^ 


2.6 DEFINITION 


/command^ :: = ^name^ GO^cIause^ 
' . ; = -<name> # 
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3. SPECIFIC COMMANDS 

3.1 TURTLE POSITION & ORIENTATION 


- Home Turtle - 




Puts turtle to the center of the screen and leaves his "track" 
if the pen is down; does not alter turtle orientation. 

/ 

- Point Turtle North - 

Faces the turtle towards the top of the screen without altering 
his position. 

- Turtle Forward - 
Moves the turtle forward one unit and leaves his "track if the 
pen is down; does not alter turtle orientation unless the screen 

edge is hit in reflect mode. 



- Rotate Turtle Right - 



o 


Rotates the turtle clockwise 45 . 


- Rotate Turtle Left - 


o 


Rotates the turtle counterclockwise 45 . 



3.2 TURTLE "SENSES" 

- Sense Color Value - 

Reads the color of the square jjn front of the turtle and puts it 

into the turtle accumulator (ACC). Background is read as zero, 

turtle tracks are read just as they were written, and squares 

beyond the screen edge are read as zero. 
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3.2 TURTLE "SENSES" (continued) 
- Joystick/Triqqer Sense - 


Tests the selected joystick position, joystick trigger and 
executes either the <or^ clause or <off> clause, based 
upon the result of the test. See Appendix F for a list of 
the select codes for the various sensible items. 


Joystick position and triggers are continuously sensed; 
there is no edge detection or reset logic. 


- Pot Controller Read 


% <selec^ 

i 


Reads the selected pot controller and puts its value in the 
accumulator; the controller range is from 0 (full counter- 
clockwise) to 228 (full clockwise). The <^select^ values 
range from 0 to 7 corresponding to the 8 pot controllers. 


- Orientation Sense - ; 

Sets the accumulator to one of 
on the current orientation: 

0 - N 

1 - NE 

2 - E 

3 - SE 

4 - S 

5 - SW 

6 - W 

7 - NW 


the values shown below, based 
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3.2 TURTLE "SENSES" (continued) 

- Edge Test - E <^true> <false> 

Tests to see if the square in front of the turtle is at or beyond 
the screen edge; if so, the <true> clause is executed; otherwise, 
the <”false^> clause is executed. 


3.3 


TURTLE MANIFESTATIONS 



Generates an audible tone using the television sound system. 



Allows the turtle to move without leaving tracks; this command 
is countermanded by the "D" command described below. 


- Pen Down - 

Lowers the pen, which means that the turtle will leave tracks 
(or erase), depending upon the current pen color selected. 

- Audio Control - 

Allows sounds to be generated as manifestations of internal 
registers of the turtle program, as shown in Appendix H. 

- Wait - 

Causes the turtle to wait for the next 30 HZ clock tick before 
resuming execution of turtle commands. See also 3.10 for a 
description of the speed control command. 
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3.3 


TURTLE MANIFESTATIONS 


- Pen Select 



(continued) 


The value of the turtle accumulator modulo 128 is used as 
the color select for turtle tracks, until changed. Zero is 

background (erase) and is not the same as issuing a “PEN UP" 
command. 


- Turtle Representation 


CTRL-T <jiumbec> 


Selects or de-selects a turtle overlay that nondestructively 


shows turtle position 
^number^ = 0, 

^number^ = 1, 

<numbet^ = 2, 

<numbet> = 3, 


and orientation at all times, 
de-selects the overlay; 
selects an arrow overlay; 
selects a turtle overlay; 
selects a point overlay. 


3.4 


TURTLE WORLD 


- Clear Screen 



Clears all turtle tracks from the screen without altering the 
turtle position or orientation. 



- Edge Rule Select - 
Selects one of four rules to follow when the turtle encounters 


the edge of the screen. 


number = 0, turtle stops; 

number = 1, turtle wraps to opposing edge; 

number = 2, turtle bounces (reflects) off edge; 

number = 3, turtle goes off edge but does not leave 

tracks until he gets back in screen boundary. 
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3.4 TURTLE WORLD (continued) 

If the turtle is not in the screen boundaries when an edge 
rule is selected, he will be put to the home position. 



- Display Mode Select - 
Preselects one of the eight display modes available (see Appen- 
dix C for descriptions of each mode). The mode change takes 
place with the next operating mode select (CTRL-M, see 3.10). 


- Color Register Values 


& <|selectN 


Allows the hardware color register selected to be updated with 
the value in the turtle accumulator. See Appendix D for the 
utilization of the color registers for each screen mode and 
see Appendix E for color register values to use to get the 
desired colors and luminescence. 


3.5 TURTLE ARITHMETIC 

- Increment Turtle Accumulator - j + | 

Adds one to the four-digit ACC; will not increment it past all 
nines . 



- Decrement Turtle Accumulator 


Subtracts one from the four-digit ACC; will not decrement it 
past zero. 



- Test ACC for j Zero - 
Tests to see if the ACC is greater than zero; if so, the <^true^> 
clause is executed; otherwise, the <fal se^> clause is executed. 


- Set ACC to Zero 



Sets the ACC to zero. 
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3.6 ITERATION 


- Iterate by Constant 


<constant> (clause^ 


Iterates the <Tclause^> by the number indicated in the constant. 


If the constant is zero, the <clause> is not executed at all. 

If <[constant)> exceeds four digits in length, the last four 
digits are used. 


- Iterate b.y Variable 



Same as above, except current value of the indicated variable 
is used instead of a constant. 


- Iterate by Turtle Accumulator 


A ^clause^ 


Same as for CONSTANT, except current value of the ACC is used 


instead of a constant. The < clause may modify the ACC without 
changing the iteration count. 



- Stop Iteration - 
When executed, makes the current iteration the last iteration 


(set the iteration count to zero) within the current i ter at i on 
level. This command will not affect outer level iteration counts. 


- Incremen t Iteration Count - F7~ 

— — A 

i — 

When executed, increments the current iteration count. Has 
no effect if not executed within an iteration. 

3.7 NESTING COMMANDS & CLAUSES 


- Basic Nest - ( <clause> . . . <^clause> ) 

Any number (including zero) of <clauses> may be nested together 
creating a single new clause, using matched parentheses. Parens 
may exist within other parens to any level desired. 
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3.7 NESTING COMMANDS & CLAUSES (Continued) 


- Accumulator Save/Restore Nest 



Behaves the same as above except that the turtle accumulator 
is saved and restored by the [■and] commands. 


3.8 


USER DEFINED COMMANDS & VARIABLES 


- Define User Command 


= <nameV ^cl ause^ 
= *<name><clause> 


Creates a definition in memory whereby the <C. clause^ may be 
invoked merely be using the <^name]>; the optional * allows 
<name>to be the same as one of the turtle intrinsic commands. 

If the clause > consists of a blank character (NOP), the {'name^ 


will be removed from the user command directory. 


- Invoke User Command 


<^name^ 

*<^name^> 


Once defined, a user command may be used exactly as an intrinsic 
command is used; however, if ^name^ is the same as an intrinsic 
command, the * must be used, as intrinsic commands have a higher 
priority in the name search. 



- Get User Command Definitions - 
This command clears the current set of user commands and reads in 
a new set from the indicated device. The device name is in the 
standard format, e.g., "C:", "D:HILBERT", etc. 


- Put User Command Definitions - 
This command writes the current set of user commands to the indi- 



cated device. The device name is in the standard format, e.g.. 


"C: 11 , "P: ", "D:HILBERT", etc. 
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3.8 USER DEFINED COMMANDS & VARIABLES 

- Load ROM Resident Command Definitions - CTRL-L ^character^ 
This command clears the current set of user commands and reads 
a new set from ROM. The character following the command indi- 
cates which of several sets to load. See Appendix G for a list 
of command sets and their content. 

- Run ROM Resident Command - CTRL-R ^character> 

- ■■■■ ■ ■■ ' 1 - 

This command performs all of the functions of the LOAD command 
described above, and in addition, executes one of the commands 
loaded. See Appendix G for more information. 

- Clear User Variables - CTRL-C 

s_ ' — 

Removes all user variables from memory. 

- Define User Variable - = # ^name^ 

Creates a definition in memory whereby the current value of the 
turtle accumulator is assigned to the indicated ^name^ . Any 
character may be used as a ^name^. See section 3.6 for the 


use of variables. 
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3.9 RANDOM TEST 
- Random Test 



Randomly executes either the <then> or the <else> clause, 
using a hardware random bit generator . 


3.10 MODE CONTROL & OPTIONS 


- Edqe Rule 

- 

CTRL' 

-E ^number^ 


CTRL-E 

0 


Stop at edge; 


CTRL-E 

1 


Wrap at edge; 


CTRL-E 

2 

— 

Reflect at edge ; 

CTRL-E 

3 

= 

% 

4 

Disappear at edge 

- Speed Control 

- 

CTRL-S <Cnumber)» 

CTRL -S 

0 

HZ 

★ 

Run full speed ; 


CTRL-S 1 
CTRL-S 2"7 


Single step (press CTRL-4 to step); 
Run with delays: 

2 = 30 commands/sec. 

3 = 15 commands/sec. 


1 command/sec. 


power-up default 
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3.10 


MODE CONTROL & OPTIONS (continued) 


- Operating Mode 


CTRL-M <^number> 


CTRL-M 0 
CTRL-M 1 
CTRL-M 2 
CTRL-M 3 


Draw mode (full screen graphics) ; 

Debug mode (full screen text); 

Splitscreen with internal registers; 

Normal mode (Split screen with input echo only). 


DRAW MODE : In draw mode, the entire screen is dedicated to 

turtle graphics. Commands are executed as they are entered 
and the user is typing "blind" (the commands are executed, 
but there is no echoing of the command name to the screen). 


DEBUG MODE : In debug mode, the entire screen is dedicated to 

text data. Commands to be executed must be entered using the 
RETURN KEY and line editing may be performed upon input com- 
mand lines. The screen shows the internal workings of the 
turtle and also shows all user defined variables and command 
definitions . 


SPLIT-DEBUG MODE : In split-debug mode, the upper portion of 

the screen is dedicated to turtle graphics and the lower por- 
tion contains four text lines. The first two text lines show 
the turtle registers as in debug mode and the other two text 
lines are for command entry. 


power-up default 
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NORMAL MODE : Normal mode is similar to split-debug except 

that the text portion of the screen is used solely for com- 
mand entry. When one complete command has been entered, the 
cursor will move to the beginning of the next line (this may 
cause the text to scroll); when the command has finished the 
execution, the cursor will move to the beginning of the next 
line. 


DRAW MODE SCREEN (MODE 0): 



Graphics data 


Turtle accepts inputs as typed without echoing them to the 
screen; no line editing is allowed. 
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DEBUG MODE SCREEN (MODE 1) 



( 1 ) 

( 2 ) 


Execution data 


User input line 


Previous command line 


User defined variables 


User defined commands 


(1) ACC = Turtle accumulator value 

NUMBER = Iteration counter value 

LEVEL = User defined command "call" level 
CHAR = Current (or last) executed command 
ERROR = Command error code (see Appendix B) 

(2) Turtle accepts inputs when "> " is present; ">" disappears 
while a command is executing. Input lines must be termin- 

■«» 

ated by the RETURN key; line editing is allowed. 
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SPLIT-DEBUG MODE SCREEN (MODE 2) 



(1) See prior page for explanation. 

(2) Turtle accepts inputs when ">" is present; disappears 
while a command is executing. Commands are executed as 
input and no line editing is allowed. 
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NORMAL MODE SCREEN (MODE 3) 



Graphics data 


User input area 


(1) Commands are scanned as input and no line editing is 
allowed. The cursor moves to the beginning of the 
line below the input line (or the input line srolls 
upward) when a command is accepted and does the same 
again when command execution is complete. 


- Display Mode 


CTRL-D <.number> 


CTRL-D 0-7 = Map to O.S. display modes 

1-8, where higher numbers 
represent increasingly 
higher resolution display. 

The system defaults to CTRL-D 6 (Display Mode 7). 

This command acts as a pre-select; the mode change actually 
occurs at the next CTRL-M command. 


3.11 NO-OPS 

Blank, underscore, and all unassigned keys are treated as no- 
operation codes. 
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4. EXAMPLES 

4.1 Set Acc = 0 

A- 


4.1 Set Acc = 23 


> A- 23+ 

<0 


4.2 Set Acc = Acc * 2 


A+ 


4.3 Set Acc = Acc * 7 


A (6+) 


4.4 Set Acc = Acc / 7 


=ZT ( 7-Z+) 
(+Z-) 


4.5 Set pen color to 1 without altering Acc 


CA-+PJ 


4.6 Find upper right corner of screen 

=XE_(FX) | 

(UNX2RXD) 


4.7 Recurse by number in Acc 


=ZT(-Z+) 

Z 


i 
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4.8 Sierpinski Curve 

=IT(-I2FI 3LG3L I2FI+)2R 
=G4F 

=Y(HNU44F2R44FRC[A-+P34(2FI)) 

After these are defined, one sets the accumulator to the 
desired order and types "Y" to draw the curve. Again, "G" 
can be redefined to a smaller number of "F"s to draw the 
higher order "Y"s. For "DGOF," the accumulator can be 
set to 5. 

The Sierpinski curve is closed and consists of four iden- 
tical sides arranged in different directions and connected 

\ 

by a short line "2F." The sides are defined (recursively 


again) in the macro "I" and the closed curve itself is de- 
fined in the last part of the macro "Y," namely: "4(2FI)." 
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4.9 Hilbert Curve 


=ZT(-VG2LZ2RGZG2LV+)2L 

=VT(-Z2RGVG2LVZRGZ+)2R 

=G4F 

= J ( HNU44F2R44FC2RDZ ) 


After these are defined, one sets the accumulator to the 
desired order and types "J" to draw the curve. "G" can 

be redefined to a smaller number of "F"s to draw higher 
order curves. 
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4.10 Trinary Tree Structure 


= G(-T(++Z-AF2R3(G2R)AFA+) (+4R) ) 
=ZT(2-Z+)_ 

=U(CHNA-4+99(4(G2R)A+) ) 


Type "J" to Start drawing; press the BREAK key to stop. 


i 

i 

i 

I 



4.11 Spirals 


= I(T(— 2(2LAF)Z)_) 
=V(++2(2RAF) ) 
=J[#IY4RU2FD4RZ] 


To run: Set accumulator = 0. (Type "A-"). 

Set #1 to spiral iteration count. 
(Type "(n+=#i]" 

Type "Q" . 


-- try n= 1 3 first) 
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4.11 Spirals (continued) 




#1 = 7 

4.12 Super Spiral 

=Q (2RIT(LIT(LIT(LIT( L ITZ ) ) ) ) ) 

=1 (UFA-2L5TR(SR)RTFD4R) 

-T- (B2LY)--initiate backtrack 
=Y (2RJT (LJT(LJT(LJT(LJT5B ) ) ) ) ) 

=J(ST(FY)I) 



To run: Put obstacles on screen. 

Type (HN9999Q) 

The command will produce a clockwise spiral figure which 

\ 

avoids all obstacles in its path. It is basically an edge 
follower with a backtrack algorithm which is invoked when 
there are no forward moves possible. 

4.13 Diagnonal Plaid 


CNR999(10F+P)] 
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4.14 Random Pattern #1 

( 1 00 (87R2F10F) ) 

4.15 Random Pattern #2 

» 

999?RF 

4.16 Random Pattern #3 

TOO ( 8?2R 1 0?F ) 

4.17 A Koch Curve 

=ZT( -ZG4L3(2RGZG)3(GZG2L)4RGZ+) 

=G2F 

=J4(GZG2R) 

After those are defined, one sets the accumulator to the desired 
order and types "J" to draw the curve. "G" can be redefined to 
a smaller number of "F"s to draw higher order curves. 
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Hilbert Curve (writ ten in Pascal) 


PROGRAM HILBERT; 

VAR SIZE , DELTA , N: INTEGER ; 

ORDER : INTEGER ; 

PROCEDURE HIL(I : INTEGER); -■ * 

VAR A , B : INTEGER ; 

PROCEDURE HIL1 ; 

BEGIN 

TURN(A) ; HIL(-B); TURN(A); 

END ( *HIL 1 *) ; 

PROCEDURE HIL2; 

BEGIN 

MOVE(SIZE); 

HIL(B); 

TURN (-A ) ; MOVE(SIZE); TURN(-A); 

. HIL(B); 

MOVE(SIZE); 

END (*HIL2‘); 

BEGIN (*HIL*) 

IF 1=0 THEN TURN ( 1 80 ) 

ELSE 

BEGIN 

IF I>0 THEN 
BEGIN 

A: =90; B:=I-1; 

END 

ELSE 

BEGIN 

A:=-90; B:=I+1; 

END; 

HIL1 ; HIL2; HIL1; 

END; 

END (*HIL*) ; 

BEGIN (*MAIN PROGRAM*); 

WRITE( 'SIZE: '); 

READLN (SIZE) ; (‘ENTER SIZE FOR YOUR SCREEN*) 
WRITE( 'ORDER: '); READLN (ORDER ) ; 

PENCOLOR (NONE ) ; 

N: =0RDER-1 ; 

DELTA: =SIZE; 

WHILE N>0 DO 

BEGIN ( ‘COMPUTE STARTING (X,Y) POSITION *) 
DELTA : =DELTA*2 ; 

N: =N-1 ; 

END; 

MOVETO(-DELTA, -DELTA); 

PENCOLOR (WHITE ) ; 

HIL(ORDER); 

END. 
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APPENDIX A - LIST OF COMMANDS 


Command 
Character 


A 


B 


D 


H 


L 


N 


R 


T 


U 


W 


Command Syntax 


# 


* 

Vk 


% 


& 


( 

0 


A<command> 


B 


D 


E<^then><else> 


H 


N 


R 


T<^thenXelse)> 


U 


W 


(blank^ <f>lank)> 


0 


Command Semantics 


Paragraph 


Iterate command by value of ACC 
Beep 

Clear screen 
Pen down 

Tests for turtle at screen edge 
Turtle forward one unit 
Turtle to home position 


o 


Rotate turtle left 45 
Point turtle north 


Value in ACC is pen color select 


Rotate turtle right 45 


o 


Color select in front of turtle to ACC 
Test ACC for non-zero 
Pen up 

Wait for next 30 HZ CLOCK TICK 
No-op 

Stop innermost iteration 
Iterate command by value of variable 


#<var i abl e^£ommand^ 

S ^s e 1 e c tXt h e n)^ 1 s Test selected joystick position 

%<select^ 

&^select)> 

(<£ommand)>. . . . ) 


Read selected pot controller to ACC 

Value in ACC goes to selected color 
register 

Binds command as a unit 
Set ACC to zero 

Sense orientation to ACC 
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APPENDIX A - LIST OF COMMANDS 

(continued) 


Command 

Character 

^ 

Command Syntax 

_ - . * 

Command Semantics 

1 

| 

Paragraph 

+ 1 

i 

+ 

ACC = ACC + 1 


t 

i 

1 

— 

! ACC = ACC - 1 


('number^ 

\number>(cornmand^ 

1 

I 

Iterates <command> by value of ('number^ 

1 

i 

t 

= <£i ame/^comman d^ 

1 

4 

; 

Defines user command 


f 

= # ('name') 1 

Defines user variable = ACC value 


? ! 

f 

? ^thenXelse^ 

Random test 


C 

£< comma nd>. . . J 

Same as () except ACC saved & restored j 

i 


— 

— 

t 

No-op ! 

A 

A 

Increment current iteration count : 

CTRL -A 

^option)* 

Audio select 

CTRL-C 


1 

Clear (remove) all user variables 

1 

CTRL-D 

<'mode> 1 

i 

Select display mode ■ 

| 

CTRL-E | 

i 

<(rule> 

i 

Select edge rule •! 

1 

CTRL-G ! 

"<fdevice^" 

Get user definitions from device i 

CTRL-L ; 

<^name^ 

1 

1 

Load user definitions from ROM ! 

i 

CTRL-M 

^mode^ 

} 

Select operating mode j 

CTRL-P 

\devicey 

t 

i 

Put user definitions to device 

CTRL-R 

(name)> 

1 

Load & run user command from ROM 

CTRL-S 

i 

<(option> 

Command execution speed select 

CTRL-T 

<^option)> 

Select turtle representation 


i 

i 

I 

i 
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APPENDIX B - ERROR STATUS CODES 

A - Operator Abort (BREAK key) 

D - Device name error 

F - User command definition area full 

I - Systems I/O error 

L - Load/Run argument undefined 

N - Nesting error (unmatched right bracket) 

0 - Overlength command line input 

P - Incomplete (partial) line input 

R - Reserved name for user command 

S - Stack overflow 

U - Undefined user variable name used 
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APPENDIX D - PEN SELECTS (BY SCREEN MODE) 


Mode 


Pen Range 
0 - 127 


Color Registers Used 


0-127 


0 - 3 


0 - 1 


0 - 3 


0 - 1 


0 - 3 


background 

PFO 

PF1 

PF2 


background 
PFO ' 


background 

PFO 

PF1 

PF2 


background 

PFO 


background 

PFO 

PF1 

PF2 




0 - 1 


PFO 

PF1 

PF2 

PF3 

background 


-- someday) 


= PF2 


PFl (luminescence only) 
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APPENDIX E - COLOR REGISTER VALUES 


Range 
0-15 
16 - 31 
32 - 47 
48 - 63 
64 - 79 
80 - 95 
96 - 111 
112 - 127 
128 - 143 
144 - 159 
160 - 175 
176 - 191 
192 - 207 
208 - 223 
224 - 239 
240 - 255 


Mid-Bright 

8 

24 

40 

56 

72 

88 

104 

120 

136 

152 

168 

184 

200 

216 

232 

248 


Color 
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APPENDIX F - JOYSTICK TRIGGER TESTS 


Select 

Code 


Direction* 

Trigger 



A 


B 


R 


B 


D 


JOYSTICK 


JOYSTICK 


JOYSTICK 


JOYSTICK 


E 

F 

G 

H 


F 

R 

B 

L 


JOYSTICK 

JOYSTICK 

JOYSTICK 

JOYSTICK 


I 

J 

K 

L 


F 

R 

* 

B 

L 


JOYSTICK 

JOYSTICK 

JOYSTICK 

JOYSTICK 



JOYSTICK 

JOYSTICK 

JOYSTICK 

JOYSTICK 


Q 

R 

S 

T 


T 

T 

T 

T 


POT 

POT 

POT 

POT 


0 

0 

0 

0 

1 

1 

1 

1 

2 

2 

2 

2 

3 

3 

3 

3 

0 

1 

2 

3 


Select 

Code 

U 

V 
W 
X 

Y 

Z 

[ 

\ 


Direction 

Trigger 

T 

T 

T 

T 

T 

T 

T 

T 

F = Forward 
R = Right 
B = Backward 
L = Left 
T * Trigger 


Device 
POT 4 
POT 5 
POT 6 
POT 7 

JOYSTICK 0 
JOYSTICK 1 
JOYSTICK 2 
JOYSTICK 3 
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APPENDIX H - AUDIO SELECT OPTIONS 


0 - audio off 

A - LSB of horizontal position "I relative to upper left corner 
B - LSB of vertical position j 
C - MSB of software stack pointer 
D _ Pot controller 0 
£ _ Pot controller 1 
F - value in CHAR (current command) 

G - (internal) - TEMP 
H - (internal) - TEMP + 1 

1 - (internal) - COUNT 

J - hardware stack pointer 


K - MSB of horizontal position 
L - MSB of vertical position 


relative to screen center 


M - LSB of software stack pointer 
N - (internal) - INPT +2 


0 - LSB of turtle accumulator 



